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Uncle DOS survives SoU bankruptcy 

Matthew Monitor and Dr, Basic also found alive 



Uncle DOS, the beloved leading character of So^Ealfc magazine's monthly 
DOStalk column, is in good condition after a close brush with death, tie will 
appear monthly in Open-Apple. a new newsletter for ^ple users, according to 
Ibm Weishaar, former author of DOStalk. 

Matthew Monitor and Dr. Basic as well as many other mythical figures, have also 
signed to appear in the new newsletter, which Welshaar will publish himself. 

Uncle DOS, Matthew, and the good doctor were found buried in Softalk rubble 
after an extensive search by Vlfeishaar. Softalk entered Chapter 7 bankruptcy in 
August When asked what happened. Uncle DOS reported, "We don't know— the 
roof just caved in on us:' 

Weishaar, developer of the Beagle Bros programs ProntoDOS and rtame^p, 
had written So/iaUc's DOStalk on a free-lance basis, tie had no other connection 
with the magazine and could not explain the bankruptcy either. 

' So/talfc was the most popular and highly-regarded of the Apple-only magazines^ 
Weishaar said. "Its rapid growth caused problems that its managers were unable to 
deal with. The magazine's readers were loyal — many still are. One reader told me 
that if he had known the magazine was in trouble he would have taken up a 
collection^ 

Weishaar said he decided to create Open-^pleto All one of the information 
voids left by SoftM's demise. 

"There are a large number of Apple^nly publications suitable for beginners^' 
Vlfeishaar said. "There are also magazines available for iiill-time professionals. 
Whafs missing is something for Intemediate Apple users— people who want to 
release the fulTpower of the Apple II in their own area of expertise, Softalk used to 




provide this information in columns such as DOStalkand Ilnd Grade Oiats, but 
few other publications seem willing-or able~to fulfill flie needs of the inter- 
mediate user." 

0pen-/1pple will be published monthly, Weishaar said, with the first issue 
scheduled for rebruaiy.The subsaiption price will be $24 a year. Potential readers 
are encouraged to encourage Weishaar by signing up as charter subscribers. 

If you would like more information about Olpen-^pple, just keep reading. You 
are holding a sample issue in your hands. Complete ordering information is on the 
back page, or if you are really lucky, you got an order card with this sample letter. 
Please fttl it out mm even If you don't intend to subscribe. Your feedback on this 
sample issue will be carefully scrutinized and heeded. 




My Two Bite 

Tarn Washaar 



Matthew Monitor, Ot. Basic, and Unde DOS as seen at the "Apple II Forever" brouhaha 
held 'm San Rancisco last spring. 



My banker s«p I'tn crazy to start a news- 
letter about an etgtt-^ear old computer. He 
says eight years is an etemlfy in ctmputer- 
time. He says the Apple JI ^ould bed^ and 
forgotten now like the other machine of 
its generation — iie MM, the Sol, the TRS-80 
Model 1, theCompiK»ior,and the Video Brain. 

For most iBi Qie test ei^t years even ttie 
people at Apple Computer, Inc. have privately 
called the Apple II a "dead machine", Th^ 
have consistently underestimated— often by 
wide margins— how many Apple Us thqr 
could sell (while overestimating ttie market 
for the Apple ill, Lisa, and Macintosh). 

The high priests of computer science think 
the machine is a joke. Meanwhile, buyers have 
managed to liberate more than two million of them ftx>m Apple's factories and 
several hundred thousand compatible machines fi^m other places. 

In his book Enhancing Your Apple II. Volume I Don Lancaster (vrfio because of 
his many articles and books about electronics is called 'the father of the personal 
computer" by tnfoWorld columnist John Dvorak and others) says: 

The Apple II is far and away the single most powerful tool eoerpiA in the hands 
of many individuals on an uncontrolled and unregulated basis. The newpersonal 
freedoms and the potential opportunities that result from this are almost beyond 
belief Its now a whole new baU game, a jump Into hyperspace from where we are. 
The Apple II is far more significant and it will have a vastly greater impact than 
such short term frivolities as the automobile and teiedsion—and, possiM}^ even 
more than the printed word itself 

Like Lancaster, I believe in the Apple II . This is the computer of the student of the 
enfrepreneur, of the researcher, of the cottage industrialist of the people. 

The combination of Apple's fatalistic attitude about the II and the machine's 
massive popularity have caused a slow evolution. Most computer companies 
periodically trash everything their customers know about computers throu^ 
radical redesigns. Even Apple has ta'ied this several times, but because we keep 
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buying the Apple II instead of more "advanced" computers, our knowledge base 
has been protected. We have benefitted from a slow progression of enhancements 
to Steve Wozniak's dream machine. 

Much of the software written for Apples in the late 1970s runs just fine on Apples 
manufactured today. Today's Apples can do more, yet none of the hours early users 
spent learning about their machines has been wasted. Today" s Apples can still do 
what yesterday's Apples did. This is very unusual in a field as dynamic as 
computers. 

The limits of the original Apple II are now in sight The full potential of the He, 
however, isn't known. And we know even less about how to harness the lie 

On the horizon is a 16-bit Apple II, currently known as the llx. This machine will 
have the memory and processor capacity to run large, powerful programs, such as 
the successors to Lotus 1-2-3. But the real beauty of the machine is that it will also 
be able to run standard Apple 6502 8-bit programs, such as Applesoft and DOS 3.3. 
On the one hand, it will run any Apple II program; on the other, it will have 
horsepower today's Apple II users have never dreamed of Best of all, it will validate 
your experience with and knowledge about today's Apple II. 

This newsletter is dedicated to the Apple II. It will follow the advances Apple 
makes to this family and it will follow the advances users around the world make in 
pushing these machines to their limits. I want OpeiMppteto be the world-wide 
gathering place for Apple II people. 

If machines are to be pushed to their limits, it's critical that users exchange 
information. Pio one can discover everything alone. Open-Apple will be a 
clearinghouse for elegant tips, tricks, and procedures. 

The information published in Open-ApplevAW come from several sources. As a 
software developer, I am able to obtain some material directly from Apple that is 
generally unavailable to the public 

I subscribe to every Apple publication 1 know about some of the things you'll see 
here are refinements of the best ideas from other publications. 

One of the most fruitful ways of learning is to take apart high-quality programs 
and see how they work. Much of my time is spent searching for beauty in other 
people's software. You'll read about my discoveries here. 

Finally, many good ideas come in over the transom— in conversations and 
correspondence with other users. You may know several things about the Apple 
most of us have yet to discover. Fart of the fim of Open-Apple is your ability to 
participate in what's published here. 

The way to convince my banker I'm not crazy is to show him a stack of order 
cards. For that 1 need your help. If you believe in the Apple 1 1, fill out the coupon on 
the back page of this newsletter and send it in. ttfe have years of adventures ahead 
of us. 



Digging 
Into DOS 




Reading a text file with an Applesoft program has always seemed like a pretty 
sfraightforwardaffeinYou open the file, tell DOS you want to readfromitand input 
it 

If you know how many lines are in the file, you issue that many input statements, 
then stop. Often, however, the number of lines in the file isn't known. In that 
situation the typical procedure Is to read the file until DOS sends an end of data 
message and then stop. 

Onerr goto errors. To accomplish this you issue an onerr goto statement 
When an error occurs, program confrol will go to your error-handling routine. There 
you check to see if the error was indeed end of data (error number five). If not you 
will want to take some frue error-handling action. But when the error is simply your 
signal that the end of the file has been reached, you want to continue processing. 

At this point most programmers send control back to their main program. This 
works for awhile, but if you read enough files in sequence your program will die 
quite unexpectedly. 

For example, try this little program. Ittries to read an emptyfile called empty over 
and over It reports its efforts as it proceeds. After it tries the 18th time it crashes 
into the Monitor— fairly unusual for an Applesoft program this simple. 

100 D$=CHRI(4) 

110 N=l 

120 FJ=''EMPTV" 

208 PRINT •■PROCKDINE WITH READ "jN : N=N+1 



The lie Meels ttie Imagewriter 

After several hours of thie usual frustration lr>'irig to get my Apple 
ImagewTiler printer to work with both a (Macintosh and an Apple lie, I 
discovered— with the help of another user v/ho iMid a working llc-image- 
writer system —ttiatthe problem was in the Imagewriter DIPswitch settings. 

Using the 11c I could only print successfully when the recognize./ignore 
eighth data bit switch (switch l-5i was dosed (ignore). The Macintosh 
doesn't seem to care what position this switch is in— i-vcn when .sciuling 
eis^it-bit graphics. The Imagewriter Reference Card, as you can ptoh ibly 
guess, recommends leaving this switch open. 

In addition, the lie uses data terminal ready protocol (switch 2-3 open;, 
while the Macintosh uses xon/xoff prototsot (switch 2-3 closed). Mighty 
handy isn't it? 

Mv ImjgewriU'i now has all thi'di|)s on switch one, ex(i:pt for nuinhtM' live, 
oprn. All are closed on switch hio when I am connected to the Macintosh; to 
use the He I have to :urn oft the printer, open switch 2-3, switch cal)les. and 
turn Uie printer back on. A switch tx)x woukt solve the lwo<able problem, 
but the DIP switdi problem looks insurmountable. Anybody want to buy a 
acintosh? 



508 L=l : ONERR GOTO 550 
510 PRINT D$;"DPEN";F$ 
520 PRINT DirREfiD";F* " 

530 INPUT T$(L) : L=L+1 : GOTO 530 

550 PRINT : PRINT DJ ; "CLDSE~;FI 
5G0 IF PEEK (222) = 5 THEN GOTO 200 

570 PRINT "ERROR tl"; PEEK (222);~ IN LINE "; PEEK (21B) * PEEK (219) < 256 
580 END 

After the program crashes, return to Applesoft with a 3D0Gar\A issue a goto 570 
command on your keyboard. Our program will report that we were killed by error 
number 77, out of memory, in line 550. 

That may seem pretty incredible to you, given the small size of this program. But 
people often forget there's more than one kind of memory to run out of. The usual 
way to run out of memory is to have a program so large and with so many variables 
that it won't all fit in your computer For example, just type on your keyboard dim 
a(1000,1000). An array of that size won't fit and you'll see ?out of memory error 
appear on your saeen. 

All stacked iqi. The other kind of memory you can run out of is called stack 
memory. Applesoft saves allkinds of stuff on the stack, which is a 256-byte area tiiat 
the 6502 microprocessor can access quite easily. Whenever you do a gosub, for 
example, Applesoft pushes tiie current line number on the stack before passing 
control to the subroutine. That way, when Uie subroutine's return is executed, 
Applesoft can find its way home by pulling the line number off tiie stack and 
jumping to it 

Modify line 500 of our program to 500 gosub 200and run it again. This will cause 
a whole bunch of gosubs to be executed without any returra. You'll again see the 
?out of memory error message; this time during the 26tti pass. But unlike when 
you typed dim a(1000,1000), you've now run out of stacfc memory rather than 
program memory. 

Just as gosub pushes a line number on the stack, so does the onerr goto 
command. And Uie resume statement is onerr goto's return The reason our first 
program crashed was tiiatwe never used resume. 

However, Uie solution isn't as easy as just beginning to use it Resume sm6s 
control back to the line in which the error occurred. If we hied to resume after an 
end o/data error, we would just get anotiieroneand our program would lodt up ina 
tight cycle of onerr gotos and resumes. 

The solution to all this is to use a call to a machine language subroutine within 
Applesoft Uiat will clear tiie stack. Use Uiis call in place of resume. The call Is 
mentioned in Apple's Applesoft BASIC Programmer's Reference Mamxsi, VWtimei 
on page 265. The subroutine lies at $F328 and can be executed with a c^f -328a 

Eariier Apple manuals included a short machine language program Uiat could 
be poked into memory and called Uiat would also clear the stack. CaJl -3288 does 
the same tiling, and is obviously much easier to execute. 

Using this call, you can put the portion of your program Uiat reads files into a 
subroutine. If you tiy this wiUiout Uie call, you get a return wWxout gpsub error 
when you by to retiim to your main program after the first end of data en'or. 

So here's Uie standard way to read a text file bom Applesoft. This prognam will 
run forever or until you press Control-C. 

100 D$=CHR$(4) 

110 N=l 

120 Ft= "EMPTY" 
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m *WT "PROCEEOMG WITH READ ";N : N=N+1 
218 EOSliB 508 
228 GOTO 288 

588 L=l : DNERR GOTO 558 
518 PRINT D$;"DPE:N";FI 
528 PRINT D$;"REfiO";F$ 

538 INPUT T»(L) : L=L+1 : GOTO 538 

558 PRINT : PRINT D$;-CL05E";F» 

5G8 IF PEEK (222) =5 THEN CULL -3288 : RETURN 

578 PRINT "ERROR tt'; PEEK (222);" IN LINE PEEK (218) + PEEK (219) » 25G 
588 END 

Seen In Print 

Steve Wozniak told InfoWorld to look for the 16-Bit Apple IIx in 1986. If you 
missed it lnfo]/\torld carried a report of an interview with Wozniak in its riovember 19 
Issue. Vfozniak said the machine would have a built-in drive, slots, expandable 
memory, and the 16-bit 65816 microprocessor. This chip can directly address up to 
16 megabytes of memory. Of course it can also emulate a 6502 and thus run 
today's Apple II software. 

In the October issue of Apple Assembly line Bob Sander-Cederlof has a report 
on the newly available 65802 microprocessor. This chip can do internal 
calculations with 16 bits but handles data eight bits at a time like the 6502. It is 
completely compatible with the 6502— Bob installed his in a lie and eveiything 
worked normally, l^ight now the chip costs about $100. The phone number for 
Apple yteemWy Line is 214-324-2050. 

I've always said ProDOS would become the Apple II operating system of choice 
when the price of hard disk drives dropped to $500. We're still not there yet, but 
we're getting closer. A company named First Class Peripherals announced a new, 
$700, 10-megabyte hard disi^ for the lie in the Movember issue of most Apple 
magazines. The specifications look pretty good, including DOS 3.3 and ProDOS 
compatibility. We'll be watching this one. Their phone number is 800-538-1307. 

The Apple PugetSound Program Library Exchange — the big Apple user group in 
the Seattle area that publishes Calf -A.P.P.LE. — recently changed the legal form of 
its organization to a cooperative and is now known as A.P.P.L.E. Coop. They've 
always had really good mail-order prices on hardware and software for Apples; as a 
co-op they may sell to non-members. Members will get patronage dividends at the 
end of the year. For people who don't need the hand-holding local dealers 
supposedly offer, A.P.P.LE. is a good place to buy stuff. Their phone number is 
206-872-2245. 

Go, Logo, Go 

After releasing the lie, Apple came outwith a new, 128K, ProDOS-based version of 
Logo called Apple Logo II. It comes with some good documentation— a tutorial 
and a reference manual — and a copy-protected master disk with the usual "as is " 
warranty The package costs $100 retail. It comes in a llc-like red and yellow box; 
don't let somebody sell you the older 48K Logo if you want this one. 

You mightwonder why anyone would buy Logo whenApplesoft BASIC is included 
"free " with all Apples. Let me duck the superior/inferior language arguments for a 
moment and simply point out that the equivalent amount of documentation for 
BASIC— the Applesoft Tutorial, Applesoft Programmers Kit, and BASIC with 
ProDOS costs $110. Thus, if your goal is simply to learn a computer language, you 
can't use price as a deciding factor when comparing Logo and Applesoft 

Both languages can be learned from Apple's materials. They are "easy " in the 
sense that neither requires formal classroom fraining. They are also "easy" in the 
sense that both are intrepreted languages. You can type commands in on the 
keyboard and get immediate execution. You can write simple programs within five 
minutes of cracking open either tutorial. With other languages (take Pascal, p(ease) 
you have to know half the language before you can add two numbers together. 

Logo has a built-in full-screen editor for writing programs. This is nice— 
especially compared to whatApplesoft provides. The edi tor isn'tquite/lppleWHter, 
but it's veiy easy to use. It can also create or edit any kind of ProDOis text file shorter 
than 6,145 characters. 

Many people think Logo is a graphics language. While graphics programs are 
very easy to write with Logo, the language goes far beyond pictures. It is derived 
from LISP, a language developed by artifical intelligence researchers. BASIC is a 
better language for dealing with numbers. Logo shines at handling lists of words, 
that is, data bases. 

Before you run out and decide to write the Qreat American Data Base Program in 
Logo, however, you should know that there's one critical problem. Apple Logo II is 
slow. Mot only do programs execute slowly they are loaded by "execing" them into 
memory 1 haven't experienced such long waits since I disconnected my cassette 
recorder and fed it to the goats. One of the sample programs Apple provides takes 
well over two and a half minutes to load. 

nonetheless, Logo has its advantages. It's a nicely structured language. You 
program by writing procedures, which are Kind of like subroutines. The name you 
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give a procedure becomes a new Logo command. Thus you create your own 
language as you use it 

The main tiling thatattracts me to Logo, however, is a book called Nindstorms by 
Seymour Papert Papert is a child psychologistand educator. He and hisassociat^s 
developed the language. In Windstorms Papert tells why. 

In Papert's vision, you don't learn Logo because you want to know about or 
program computers. Instead you learn Logo because you want to know, period. 
Papert presents Logo as a language for (earning. Programming in Logo provides 
intellectual models, Papert says, that are othenvise rarely available. Using the 
computer, these models can be manipulated by people and readily absorbed. 
Learning Logo is supposed to be an adventre in teaming, not an adventure in 
learning about computers. 

In this column we're going to present tips and tricks for using Logo. They'll be 
based on the same kind of peefcs, pokes,andGa2<sour other stuff revolvesaround. 
Precious little work that I can find has been published in ttits area, soa lot of Ms 
column will be breaking new ground, Any ir^t you might add to this procedure 
would be appreciated. 
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Fontrix. By Data Transforms, Inc. This program has received several favorable 
reviews and has some impressive advertising. The Apple version of the program 
has some severe limitations, however, 

Fontrix bills itself as "extended screen graphics software!' This is a good 
description of its most impressive feature — the ability to aeate and print graphics 
that are much larger than a single hi-res screen. 

These graphics are stored in a special file fontrk calls a graffile. Qrafiile size is 
defined in sectors and can range in size from a single hi-res saeen, which is five 
sectors wide and six sectors high, up to 480 sectors in any combination of width of 
height that's larger than a hi-res screen. 

You can create and print a graphic the size of a single sheet of paper, for example. 
The exact size depends on your printer; the Fontrix manual includes a table 
showing the possibilites. Most Epson printers can handle graffiles 17 sectors wide 
by 26 sectors high. Most other printers, including Apple's, can handle graffiles 11 by 
24. 

The program has three basic modules, a graphic writer, a graphic printer, and a 
font editor. The fontrwcdisk comes with 11 fonts. You can create more yourself with 
the font editor, or you can buy additional fontpacic character set disks from Data 
Transforms for $20 each. The maximum character cell size is 32 by 32 pixels, 
normal Apple text is 5 by 7. Characters can be either all the same width or 
proportional^ spaced. The only input device recognized by the font editor is the 
keyboard. 

The graphic printer is a limited program compared to many of the graphic 
printers available today It allows inverse or normal printing on 8.5 or 14 inch paper 
widths. A magnification option accepts choices from 1 to 255, but choices over 3 
result in some of the graphic being cut off on the right hand side. The only other 
options available relate to where on the paperagraphicwill be printed— ri^t side, 
center, and so on. 

The graphic writer is the module you use to actually create displays. It allows you 
to type fonts on the screen. Some primitive graphics abilities are also available, 
including background colors and patterns, but Fontrix is clearly not a drawing 
program. Graphic input devices can be used, but only to position the cursor. This 
can be handy when non-character fonts, such as electrical, mathematical, or 
engineerirtg symbols, are being placed on the screen, but is of little use with 
sfraighttext 

In advertismentsyou will see stunning graphics created with Fontrix These were 
no doubt created on the IBM version of the program, whrch has more advanced 
drawing capabilities. 

fontruc is presented in advertising as a typesetting program. The Apple version is 
virt;ually useless in this application, however, because you can't send text files 
you've created on a word processor to the graphic writer. This is possible with the 
IBM version, but not with the Apple version. In addition, the program has no 
provision for justifying text on both margins. You should also know that the 
examples of rontrix printouts included in advertising and the manuals have been 
photographically reduced. The manual makes this clear and recommends a 
reduction of about 40 per cent for best results. 

The day will come when software will be available that will turn an Apple II and 
upcoming laser printers into typesetting machines, tlowever, we aren't there yet 

Fonmx 1.2, by Data Transforms, Inc. (616 Washington St, Suite 106, Denver, Colorado, 
B02XXi, 303-832-1 501). Unprotected. "As is" warranty. $75 
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Picking Up 
Applesoft 




JlsMng a poke at the Garbageman 

e«a^x)i^hasaneme^lfemilethash]ssiiq>4atbecBat^ 
Nddla Peter Rabbit has Nr. McQregor. Api^soft programmers wotMng under 
DOS 3.3 have the Qaibagmm 

When theM>agBnKm sfaik€S, your Applesoft program will come to a sudden 
and compteii halt Ybur keyboard will go dead. Your face will look confused and 
anmy. Utou wffl probably hit axitrol-reset unless you've met the Garbageman 
before. In that case you will sit and wait After a pause of something between a few 
seconds and a few minutes, the Qarbageman, his can iiill of eledionic detritus, 
suddenly flees. Your Apple will mysteriously start woridng perfect^ again, 

What strings. Consider the following famous pro^m. which originally 
appeared in So^Uc 's DOStalk a couple of years ag/x 

19 INPUT -WHAT? -;H$ 
2e GOTO IB 

When you run this program, the word "WHAT?" appears on your screen with a 
cursor beside it You ^e "WITCHES" and press return. Applesoft puts the word 
"WITCHES" in an empty place inside your computer It also stores the length and 
location of "WITCHES" in a table used to keep track of such stuff. Its called a 
uailaMe table. 

The empty place where strings are stored extends fi-om where the variable tables 
end to where DOS starts. The first string is placed right up against DOS. The next 
one is tucked in next to the first Figure 1 will help you figure outwhere this string 
storage place is inside your computer. 

The Idt-most bar of Fipre 1 represents the entire range of Apple 11 memory and 
shows its standard uses. The middle bar shows how Applesoft splits up the "free" 
memory area from byte $800 (in decimal thafs 2048) to byte $9600 (38400). 
Applesoft uses this area for storing your actual program and your program's 
variable tables and strings. The right-most bar of figure 1 gives you a peek inside 
the string stcHage iffea ftielf. 

Usually memory maps are presented with the high addresses at the top. Some of 
you may think the Open-Apple map is upside down. We do it that way because it 
matches what you see when you examine memoiy using the Monitor. It takes only a 
fm? minutes of trying to match what you see in the Monitor's memoiy display with 
whatyou see in a standard memory map to realize that it's the standard maps that 
are upside down. 

Since the first sWng is stored right next to DOS and the second next to the first 
theorder in which they appear in memoiy is backward fi-om the order in which they 
are used, note in the right-most bar of Figure 1 that our first sfring, "WITCHES ", 
appears as the last word in the bar 

If line 20 of our famous little program said print a$, Applesoft would look in the 
variable table until itfound the enby for a$, then would use tiie length and address 
stored there to retrieve "WITCHES". 

Why the Garbageman takes so long. Ah, but the next command isn't print it's 
goto 10. Our input statement is repeated. In response to the second "WHAT? ", you 
type in "QOBLINS". Applesoft now stores "QOBLIMS" in unused memoiy, right next 
to "WITCHES", and changes the length and address for a$ in the variable table. 

Applesoft keeps track of where the edge between empty memory and the string 
storage area is by means of a pointer kept at bytes $6r-'70 (111-112). This pointer is 
called fretop in the Applesoft literature. It too, is shown in Figure X along with 
several other mteresting pointers. Whenever you enter a new sfring, Applesoft 
nSm to ftetop to figure out where to store the string. 



Since your program has changed the value of a$from "WITCHES''to 'XX)BIJI1S'', 
Applesoft conectly assumes you are no iongeriiiterestBdiii IRTOlE^.'niewQid 
"Wrrcn^ is sUn in memory, but because its length and address have been 
ovennftten ^ the length and address of "QOKJNS", Applesoft can no longer find 
it 'TWTCH^ is now an Inacf foe string 

"WHAT?" You type In "BROOMSTlOi" and a couple thousand similar words. 
Eventually Applesoft will go to store a word you have typed in and find file strings 
have bumped into thevariable tables— flMxe is no more empfyin(anoiyleft.Atttiat 
pointApplesoftcdlsontheCknbatgemantDesn^ilKvar^iletabie^iindailfiie 
"acdwe" stni^ and oonsdidate them down at the DOS mi memory. Mta Vtm 
consotididon, fretop wiil be changed to point to tiie new boundaiy b^ween the 
active stings and the restof memory. All the memcny held by "inactive" sbrii^wQl 
be fireed and made available for reuse. 

The Qanbagonan has a lotof work to da Hecan'tiustgo in,flnd the first active 
sb1ngintlKKmiabletabie,andmowitne!rttQDOS.irhe(ftl,hem^o«aw^ 
anoOieradive sbing. So what he does Is seaitli ttnni^ tlK et^mWe taUe 
and find the m^ive string that is already closest to IX)S. Then hemov^ it Mo the 
first position In ttte string storage area. 

This happeis in a flash with the little program weVe been using. Knee tha:e is 
only one sbiiqvariable being used (a$), the Garbageman (pdd^ finds its active 
value, moves itand disappears. You probably wouldn't even notioelie had stopped 
by 

But programs that have a M: of string vaiiables '-particulai^ programs with 
large string arris^-really iow the Qarbageman dcnm. Por &m varfode in flte 
tirble, he miiM look Sm>i^ tlK oitire vaiiiMe tad>te once. The HKHB variables in 
tlK table, theinorettaeshemi^lookandihe longer itwDI take to lookthrough it 
each time. 

A deaonsbealloii. If you'd Hke to measure the effiscts of ttie Qarbageman 
yourseK try IMs itUe progam: 

le 1-250 

20 DIM 3S(I) 

3» FDR TO I 

A» : GS(Xl°5T8t(X) 

5a : PRINT G«(X) 

ee NEXT 



Whenever you turn on the Apple //e or //c 80<olumn card with a pr#3, the 
screen is cleared. This Is great when your program begins, but what if your 
program later turns on a printer with a pr^l? To return to the screen after 
printing do you have to destrc^ uAiats already there witii anottier pr#3 
oammand? 



78 PRINT -cnUCTIMB BfllfflflEE-; CHR$(7) 

88 ir PEEK(97B)xl98 THEN X=FRE(e) : HEM flpplssoft/OOS 3.3 

as IF PEEK(97B)=19e THEN PRINT CHRS(4);TRE" : REM ProDOS 

99 PRINT "GflRBflGE COLLECTED'; CHRI(7) 

Line 10 determines how many sbrlngs our program will have. Line 20 dimensions 



Text Scrnn 



TSTTflB ($67-68) 
URRTflB C$69-6fl) 
STREMD I$6D-6E ) 
FREIOP l$6F-70) 
MEMS 1 2 ($73-74) 




tOOOO TO $FFFF 



Figure! Applesoft siring storage 
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a string array of length I, Lines 30 through 60 fill the anay with strings. Lines 70 
through 90 allow us to measure how Iwtg the (kurbageman takes to dean up this 
many string 

You maybe somewhatpuzded by linesSOand 85. lb understand these twDlines, 
you first have Id Imow that PRdX)5 includes its own Qarbageman. tie is 
fester than the one buiit into Applesoft as we'ii soon see. 

A program can tell if it is running under I^oIX)S or IX)S 3.3 by taking a peek at 
byte 978 ($3D2). If this byte is equal to ISO, ttien ProDOS is active. If itisaiQithing 
thai you are running unda DOS 3l3. 

If you are running with DOS 3.3, )DU can call the Applesoft Qartxgeraan and ask 
him to dean up with the command ]pfK(0). lb call the PtoDOS Ombag/eman. 
however, you have to use a DOS' command. Thus, in line 83, we print 
chiiWrfre". 

Ator ^ng in the pN^ram EBid runitii^ it increase the val ue of I In Biie 10. TMs 
wffl iMsi^se the numbc? of strings in the program. Garbage coiiecQcai will take 
longa and kxtger. Here are some sample flmlngs: 



Barbaga collection tltne 
In saconde 



number of 


DOS 3.3 


ProDOS 


strings 






256 


5 


e.i 


see 


19 


e.z 


IMS 


IM 


e.s 



Speeding iq> the GartMgeman. Back in January 1981, Call ■A.P.P.l.E. pub- 
lished a program by Randy wggington (one of the very first Apple employees— 
currently famous as the author of MacWHte) that could make the Qarbageman fly. 
The program worked by finding the 16 active strings dosest to DOS on each scan of 
the variable table, rather than Just the dosest one. lather than searching through 
the entire variable table once for each variable, the new technique scanned once 
for each 16 variables. 

Apple's programmers used a similar technique in the ProIK)S Basicsystem 
software. That's why the ProDOS Qarbageman is so much fiaster than the (xie built 
into Applesoft. Thus, the obvious way to escape the lulls caused by A^esoft 
garbage collection is to use ProDOS rather ttian DOS 3.3. 

A second way is to incorporate Wiggington's 305 t^e machine language 
program into your DOS 3.3 program and call it eveiy once in awhile —just often 
enough to keep Applesoft's own Qai1)a^an at bay 

Botti of these solutions have some problems, however. Lots of people still seem 
to prrfea- DOS 3.3. ProDOS does give many new features but they come at the 
expense of memory. ProIX)S requires users to have 64K in their machines but 
leaves less program space than 48K DOS 3.3 does. You could stick with DOS 3.3 
and use Wigginton's program, but it is long, hard to find unless you know where to 
get back copies of CaU ■A.P.P.L.E., and is copyrighted by Apple Computer, Inc 

Selective String Preservation. There is, however, another way to foil the 
Qarbageman. This technique was developed by Clay Ruth and was described in the 
August 1982 Call -APFLE.. The technique, which is relatively easy to implement is 
called setecfiue stririQ preservation. Using this technique, you take out the garbage 
yourself by making a simple pofce. Programs that use this technique avoid calls to 
the Qarbageman complete^ and thus run even festo' than Pn>D0S4)ased 
programs. 

To see how the technique works, lefs imagine an elementary order-entry 
program for a pumpkin factoiy. Each time the factory receives an order, the name 
and address of the purdiaser is entered. Then the program asks for a pumpkin 
identification number (they come in many different sizes, shapes, and shades) and 
the quantity ordered. The program automatically looks up the identification 
number to figure out if that kind of pumpkin is available and its price. 

Once ttie first item is found, the program asks for another pumpkin identifica- 
tion number (we hope if s a large order for many different kinds of pumpkins). The 
process continues until there are no more items, at which pointthe program saves 
the entire order in a disk file and prints an invoice and shipping papers. Then Oie 
program starts over and asks for ttie name and address on the next order. 

This pro-am, and most other database-^pe programs like it involve two kinds 
of shing variables. First there are permanent shing varables. These are variables 
that are assigned a value only once. They may be referred to over and over again, 
but they don't actually vary. The DOS d$ is a good example of a shing variable that is 
assigned once, is never again changed, but is used ttiroughout most programs. 

In our order entry program, we would also have a large, permanent, string array 
holding pumpkin identification numbers. These would be strings like "RX-ll-Pink" 
or "JC-O-Light ". Whenever a pumpkin ID was entered, we would scan the array to 
make sure that the ID was val id. The I D's position in the array could also be used as 
a record number for a random-access inventory file. 

In addition to permanent sbing variables, our pumpkin program would use a 
number of temporal?/ string variables. These are variables that are assigned one 
value on the first order, a completely different value on the second order, and so on. 
After an order has been saved on disk and printed, the shings associated with 
these variables will not be used again. These temporary string variables hold 
information such as the name and address on the oixler and the ID numbers and 
prices of the pumpkins, 



Any software similar to our order-entiy program is exactlywhattheOarbagonan 
loves to muck up. After entering an order or two, all availalde memory wouM be 
filled upi 

Garbage colledion wouM be slow because ttie siring array holdiiM pumpkin 
itfentiSauaon numbers aiotiewouM typically have SOO or more Items inl. Meven 
OHintbigail the other sbings in the po^am, the Qarte^eman would gettoscan 
flie 500 fflray sbings 500 omes. Your computer wOI lock for what seems Wse 
farem. 

Beating the Gai1»genian to his oim ganK. In the selecdve string ixesetva- 
tlon technique, the programmer tates care to make sure all the sMngs that will 
never be changed are assigned values fi^t Hiis will pack them all together in Uie 
area of memory right next to DOS. Then ttie programmer takes a peek atftetop. 

The first order & taken. Temporary strings are placed in meniixy between the 
variable tables and the permanent strings. When we are finished processing the 
first order, we poke thevalue pi«riously{Dund in fretopbadi into fretop. This t^ 
Applesoft Into storing the next group of temporary strii^ ri^t over the top of 0ie 
first group. 

The second order is taken. Its temfXHary string are placed in memory, again 
be^nning right next to the pennanent^inigs. At the end of the second order, we 
ag^ poke freli^ with its original value. 

Using this technique, we constanOy force new temporary strings to ovHwrite the 
old, no^onger needed ones. Consequently, &ie strings never fill up your Apjde's 
memoiyand the Qarbageman is never called, Hete'swhatourorderenttypre^am, 
which uses the technique, might look like: 

lee GDSU8 leee : rem !nlUaU2e progran 

lie Din IN«(5ee) : &BB liee : rem li»d index array 

IZe FT = PEEK(lll) + (ia<tl.l2)«2S6 : RQI saue value in frettsp 

138 GtSttl ,2888: ; REfi jet naniB and address 

lie Sasm Zlee : REH get Itens 

ISe GDSUB aeee : REH save order on disk 

168 GOSUa 3588 : REN print invoice, etc 

178 POKE 112.FT/25S : PBCE lll.FT - PEEK(112)«2SS : REM fix freetop 

188 GOTO 138 : REM do next order 

...program subroutines start here 

The important lines are 120 and 170. Line 120 saves Ore value in fi-etop after all 
permanent stings have been assigned. Line 170 pokes this value back into fretop 
when it's time to dear ail the temporary strings. 

Implementation tips. If you decide to use this technique, here are some tips. 
First use great care in splitting the permanent strings fi'om the temporary stiings. 
In long, complex programs, you may have to use more than just two stringgroups. 
For example, you may have completdypermanent shings, sanl-permanent 
strings, and temporary stiings. 

In tills case you would save the fretop value twice, in different variables. This way 
you could delete only the temporary stings by poking firetop witti one of ttie values 
and you could delete botti ttie temporary and the semi-permanent strings by 
poking in the ottier value. 

Don't try to poke new values into fi^etop until you have all other bugs out of your 
program. If you change fi-etop at the wrong place in your program, very strange 
things can happen. As RuUi pointed out in his original article, it is heipllii to know 
ttiat tiie pokes to ft'etop, and not some other bugs, are to blame. 

When the selective sh-ing preservation technique is to blame for the bug, here's 
what happens. Your program tries to use a variable that was previously given a 
sbing value. But instead of the assigned string, Uie variable contains gibberish, or 
worse. This is because the original string assignment was placed in Uie temporary 
sfrings area and was later overwritten. 

It is easy to get mixed up and think that since you assigned a value to a variable 
before peeking at fretop ttie first time, you can later safely change the value. It kind 
of seems like the new value should get stored in Uie permanent string area. But it 
won't Remember ttiat the values In your permanent strings cannot be changed. If 
they are, the new value will be stored in your temporary shing area, and the old 
value will become wasted memory space. 

One way you can get around this is by assigning values to sti^ing variables right 
inside your program. For example, if you have a line in your program such as 1000 
f$="scary stuff", the pointer in the variable table will point at the sbing where it 
appears in your program The string 'SCARY STUFF' will not be moved into eilher 
the premanent or Uie temporary shing storage areas. 

This only works for program strings assigned wiUi quotation marks. For 
example, d$=chr$(4} will put a confrol-D in the shing storage area; d$="' : rem 
invisible control-d between quotes will not 

If you are using ttie selective shing preservation technique, avoid the fre(O) 
command. This command calls the Qarbageman and asfcs him to attack. What we 
are trying to do here is haul ttie garbage out ourselves, thereby completely avoiding 
ttie Qartiageman's time-wasting visits. 

Once you get the selective string preservation technique down, you'll find it quite 
helpful for those sting- and disk-intensive data base programs you are writing. The 
Qarbageman will no longer be your nemesis. 
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Life and times 

I subscribe to a Time-Ufe newsletter about fifties 
that costs $48ayear.Howwillyouand«feidiffiur^!n 
business with a price only half that? 

WUeyCatt 
inotefkee Swamp 

The Odober mm of Time-U^s fetter listed seuen 
©iiacutiuesaraf ^teenoontrfbutors. TTiecomnttttee 
Oat puts togeflier Open-Apple is smaUer—pst 
Hfeishaar and ^ or seoen of us imagina/]/ creatures 
—so our ouerfiead&iower.1Tme-i^e sells its I^rto 
the U.S. iiusbie^communt^ wUdh is used tops^b^ 
too much for eoi^ufer-related services. C^iW- 
ylpple's market, on the otfter/tawt Is the woM-tMe 
j^ple user conununiQ^ uAich demands geOb^ its 
mmey'suxHili 

Save the trees 

Why is Open-Apple printed on such light-weight 
paper? 

P.T. Bridgeport 
Oltefenokee Swamp 

It saves postage (partiadaiiy to subscribers living 
outside north America), space InyowfUedrawer, and 
gives us a distinctiue feel (youll never get Open- 
Apple mixed up with Byte, for example). The news- 
letters will be proteded t>y envelopes in all subscrip- 
tion mailings. 

From cotton to apples 

Open-Apple looks interesting and I am consider- 
ing a charter subscription. But could you please tell 

mell^shaED'scpdfficaiionsasaneMMs'puUlsher? 

HowlandOwl 
OI^iKriteeSwamp 

Hfeishaar (pronounced lOs&w) is a piofSsssionai 
Journalist who has been uxnM^g vMk oomfmters 
simxMtm in college, tfe recefoedaMf^rsd^ree 
bi,^maiism from the IMuersi^ df Eanm in 1975. 
He ttm worked at Emtm^ tkm Semkxs, an 
dectonic news mmx far ammttty traders. At 
cnsweishaarstaiMmaniaaagedagmp<^four 
weeMy newsletters. Lata; as the compmy's MiaaQ- 
ing Editor for operatKm, H^^aar was heauUy in- 
volved in a diar^eouer of the wm^m's entire 
editortai dq)artm&a pm tmemUm srta tetOigK 
machines to computers and termtnal& We was also 
inuoioed in the deoeiqpmait o/neu> eiectonic termi- 
nals ^ ens customers, the termfeiats r^Oaced 
te(e^macfibiraandear%dot-matrl!cpr6^rs. 

Hfet^iaarbougfttanylpple II in 1980.Ayeiarlaterhe 
left CliS to devote fM time to the potenM of the 
A^ie. He is an accompUsted Basic and assenMy 
laHgiagfi programmer, ite has ^o^toped two pro- 
gram& PMDtoDOS and ramtVp, that hane been 
published by Seagie Bras. Both programs appear 
frequently on best-seller lisis of ^ple uMy pro- 



grams. ProntoDOS was chosen as one of the best 
new programs of 1983 in Softalk's annual reader poll 
(Softalk, /^ril 1984, page 73). 

In addition to programming, Weishaar wrote 
Softalk's monthly DOStalk column from April 1983 
through the final Issue of Softalk in August 1984. 
During that period he also wrote articles (DOS Be 
Nimble, DOS Be Quick, i^farch 1985; Breaking the 
Floppy Barrier: An Introduction to ^le's Pro- 
DOS, Januar]/ 1984) and was one o/theSoftalkSages 
who answered readers questions in the If-llieii- 
Naybe column. 

Weishaar is a member of the Apple Bits Users Group 
in Mnsas City, tie is frequently invited to mate 
presentsiians to groups ofAppie users. 

80-column puzzle answer 

(Question on page 6.) 

lb return toUie BlVcolunm cardwtthoutcleaiingflie 
screen do ttiis: 

DOS 3.3 

POKC Mi?S POKE 55,195 ! qfiLL 1082 

ProDOS 

PRINT D*;'«ai(WC3B7- 

IMs tt1d( recmmects ttieM^tumn firmwe '& its 
warmstait a^w& ($C307), iMch doesnt cteaur ttK 
screen. M DC^ yon can safe^ do this t^poMi^ 
the warmstait address Into tlie paQ&zero output 
hooks and calling the page-3 vector table routine at 
%SeA (1002), which forces DOS to use the current 
contents of those hooks forftihire output 

VWth ProDOS, this same tifck can be accomja^wa 
much more e^ily because the al^ddress) parameter 
can be used with the ProDOS pr^and in^commands. 

By the sea 

Do I need to watch the SuperBowl this year? 1 
missed Apple's Big Brotherad last year and my life has 
been a mess ever since. 

Churchy liaremme 
Okefendkee Swamp 

TTtings weren't real swell around here, either, 
though 1984 wasn't as bad as some predicted. Last 
year I was in the bathroom during i^pie's ad ami L 
too, mtesed U. Do you really tMnk ihat2s the noot 
cause (tfour troubles? I predict OatAi^ uM Imy 
anotherSi^rSowl spot this j/earand that it wSionoe 
a^iin be more mterestlng than the game. You read it 
here^rst. 

Where is the beginning? 

I'm intere^ in doing some int^&c^ tridis «Ath 
my Apple, sudi as hooking two f^ifAea togdher and 
mnnectlng stuff to the game port ttawever, I am a 
complete beginner at electronks. Wieie ^oidd 1 
begin? 

Qrundoon Qroundchuck 
Okefenokee Swamp 

first of all, if j^ou don't know how alreadit youhsoe 
to learn to solder (pronounced soddar). Soldering isa 
(ecAr^ue ^ oonnectir^ etectronlc oomporients and 
wta bother us^heatandatin-leadaiioj^Soider- 
ingprouides a good dectrUsi connection that is aiso 
j^^ioil^ 8tre% 

f« addfflon to Its use in electrical work, solder Is 
also used in many other situations. The gutters on 
your house are probably soldered. However, if you 
fcnow ail about non-electrical soldering, you know 
Just enot^h to be dangerous. Electrical soldering 
requires both smaller soldering Irons (the device that 
prooides the heat) and a different fclnd of solder (the 
tin-lead Mloy). 
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tleathklt sells a self-instructional icit on soldering. It 
costs around $20. It includes an excellent book and 
some electronic parts you can safely destroy while 
learning. If you're interested in the hard side of the 
Apple II, this kit is a real good starting place. 

If you don't have a soldering iron, don't buy one 
until you need it The first part of Heathkit's book 
describes the uarious icinds of irons that are available 
and what kind j/ou need, fiadfo Shack sells adequate 
ones. 

tlere at Open-Apple we lt help you out with a 
column called Bus School, It will be about Apple 
hardware and techniques for cormecting ycM Apple 
to the world. Watch for it 



Replacement reading material 

How that Softalk is gone, what Apple marines do 
you read and recommend? 

Mam'selle Hepzibah 
Okefenokee Swamp 

InfoWorld, while not an Apple-only magazine, is my 
favorite. It's a weeWy and concenlrates on news in the 
microcomputer industry Its editors have a healthy 
respect for Apples: you won't feel short-changed 
reading this one. In addition to news, InfoWorld 
publishes lots of reulews and a couple of ixry good 
columnists. 

Call -A.P.P.LE. and Apple Assembly Line are my 
favorite Apple-only publications. When you read these 
you feel like you're among friends— people who 
have Apples, use them, and are trying to share their 
discoveries with all of us. 

Hardcore Computist isani^ple-onlj/ magazine with 
a single-minded devotion to one of today 's most pop- 
ular hobbles— defeating copy-protection schemes. 

nibble has always been a whole-heartedly Apple 
magazine. It is targeted toward new users, however. 
For some reason, I often have the feeling that many of 
its articles are written by minors. 

A+ and inCider have always struck me as oppor- 
tunist publications. Both are late-comers from pub- 
lishers who first had other computer magazines. Most 
articles appear to be written by either CP/M holdouts 
or professional free-lance writers who do articles on 
Commodores one day and Apples the next. 

If your main interest is the advertising, A+ now 
appears to be the thickest Apple magazine. 

Variable recovery 

Why is it that the vAms tiS all variables are deared 
whenever the most minor f3mw ^ ">ade toa Hne of 
an Applesoft program K^ntQ In memory? 

I have worked wiBi ottio' madiines that let you 
change a program line, issue a goto to resume 
proc^sing, and have all variable values sW intact 
This is a big aid in debugging a pro^m ^nce you 
need not start back at the beginning with a run. 

is there a poice or some other technique that will 
restore pointers or values for variables in Applesoft 
afto-aUeringaprogram line? 

tIaroidr.WUIiams 
Hutchinson, Mirni. 

The reason Dr. Basic clears all the variables is that 
your program and its variable tables are a^acxnt to 
each other in memory, (see Figure 1 on page 4of this 
newsletter.) When you edit a program, the memory 
space used by the program listing Itself gets either 
bigger or smaller. 7b keep the variables Intact they 
would all have to be moved to keep them acpoentto 
the program. 

The other you've worked with probably use 
a differerd memory allocation scheme so (hat the 
problem doesn't occur. 

If you are using ProDOS, however, there is a 
solution. Before editing your program, issue the store 
command. This will save the current ualues of ail 
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variables in a /i(e on your disfc. After editing, issue a 
restore command to bring the mtriiMes back into 
memory. Goto (notrun!) will then resume processing 
with all variables intact 



Putting RWTSin solitary 

Is there any way to edit DOS 3.3 so only the RWTTS 
subroutine and boot up procedure are left? Would 
this free up space on the disk? Also, on some disks 
that 1 boot up, the cursor flashes, but on others, it 
doesn't. I have searched the DOS manual, but have 
found no information on either subject 1 would be 
^atefiil if you would answer these questions. 

Albert Ting 
Bellevue,Vl^sh. 

A flashing cursor indicates you are using Apple's 
40-column firmware. A non-flashing cursor indicates 
you are ustng^{^'s 80-column firmware (activated 
by programs on some of your disks via pr*3.). tlote 
that the 40-coiumn firmware cannot display 80 
columns, but the &)-column firmware can display 
either 40 columns fpress esc 4) or 80 columns fpress 
esc8j. 

To edit DOS down to just RWTS, put a LDA $C08aX 
JMP $FF69 at $B70E and initialize a new disk (from 
the Monitor enter B70E:BD 88 CO 4C 69 Tf). When you 
boot this new disk. BWTS will be loaded normally, but 
then our new instructions will turn off the drive and 
jump to the Monitor rather than continue loading the 
rest of DOS. This effectively frees up sectors 10 
though 15 on track and all of tracks 1 and 2, 
however, you will have to unmaric the VTOC's free- 
space bit map on the neuAy ihitiaUzeddl^yow^^. If 
you don't know how to do this, see the March 1984 
DOStalk. 



Running without filenames 

1 need to create a DOS system that would allow me 
to simply boot up a disk and run a machine language 
program at a certain sector on a given track. I'd also 
like to be able to load other programs, given a track 
and sector. 

I wish to do nothing more. Pio filenames, no file 
directory, just what 1 have said. I have tried this before, 
but soon found 1 just didn't have the necessaiy know- 
how to do it 

JeffBiggus 
Glen EUyn, III. 

The easy way to run a machine ianguage program 
on start-up is to modify the DOS boot routine at 
$B700-$B749so that itloads your program Instead of 
the DOS command Interpreter and file manager (see 
previous letter— but don't do what it says there^. 

To do this, start by storing your main program on a 
disk in ascending sectors, for example, if your 
program is $1200 bytes long use a disk zap utility to 
store the first 256 bytes in track 1/sector 0; the 
second 256 bytes in track l/sedor 1; and so on When 
you've filled track 1/sector 15, go to track l/sedor 
and continue until your entire program is on the disk. 

now, to get this program off the disk and back into 
memory, use the disfc zapper to change the rmmtier at 
$B7E0 (track 0/sector I byte $E0) to the number of 
sectors used to store your program; the numbers 
$B7E7 (track 0,/sector I byte $E7) to the high-byte 
address where j/our program 's final sector should be 
loaded (low-byte of address must be zero): the 
numbers at $B71S and $B71A (track 0/sector I bytes 
$15 and $1A) to the numbers of the track and sector 
where that final sector is stored. At $B73B4B73D 
(track 0/sector 1, bytes $3B-$5D) put ajump ($4C) to 
your program's starting address. 

For example, ^your program starts and loads at 
$2000 and Ss $iWd bytes long, put the stuff from 
$2000-20lTat trade 1/sector 0; $210Q-$2in' at trade 



1/secfor 1; $2IW-$2m' at fracfc l/sedor f; $3000- 
$301Tattrack2/sedorO; $3100431IT(the endofthe 
program) at track 2/sector L Then put $12 (the 
number of sedors) at $B7E0; $51 (the high-byte 
address of the program's final sector) at $B7E7; $02 
and $01 (the tracfc and sector of the program's ItnaJ 
sedor) at $B7l3 and $B71A.M $B73B put 4CO020 
Omp$2000j 

The program will be loaded and run automatically 
when you boot. Vourprogram can load and run other 
programs, if they are stored on the disk using the 
same ascending-sedor scheme, by making the above 
changes in memory, loading the X register wtOi 
what's at $B7E9 (the slot number of the disk drive 
times 16), and jumping to $B700. 

HeDaP heaven 

All this talk in the computer magazines about the 
"sorry" state of computer documentation is disgust- 
ing. Users act as if they have a Constitutional rig/it to 
Information about how computers and software work. 
But as any student of the history and traditions of data 
processing knows, this information has always be- 
longed solely to the Heros of Data Processing (HeDaPs). 

There is nothing new about the notion that an elite, 
closed group of people should control the technology 
of the time. That's how witch doctors did it and what^s 
good enough for them is good enough for us. 

Just imagine the sorry state the world would he Iri 
today if users had had access to witch doctor infbrma- 
tion 10,000 years ago. A careless user might hase 
ridden a spirit hard, put it away wet and contaminated 
all the spirits. If anyone could be a witch doctor, then 
everyone could be a witch doctor; and then no one 
would really be a witch doctor; and then where would 
we be? 

1 am not a HeDaP myself. But I do acknowledge that 
theirs is the power and the gloty. Regrethilly I must 
admit I didn't always understand that There was a 
time when It seemed to me that computers couldn't 
be any harder to start than lawnmowers. 1 argued 
constantly with one big HeDaP in particular aboutwho 
should be allowed to use the power of our company's 
computer, tie patiently explained to me many times 
how damaging us common bunglers can be to big 
computer systems. 

Unconvinced and unrepentant I snuck into an IBM 
seminar for HeDaPs. The seminar was about a 
machinecalled the DisplayWriter. Around the seminar 
room stood unique beings— half from the world of 
technology and half from the world of commerce- 
called Sales Engineers. The Sales Engineers sat each 
HeDaP down in front of a machine. A little stick man 
made of letters popped up on the screen and started 
to dance. Curious, I pressed a key on the machine's 
keyboard. The man stopped dancing. A Sales Engi- 
neer approached but neither he nor any of his 
colleagues could make the man dance again. My 
machine was dead 1 had, with one uninformed key- 
stroke, killed a little dancing man — to say nothing of a 
computer priced at 10 grand. I was embarrassed and 
Sony and knew from that moment on that computers 
must be protected from the masses. 

Perhaps the greatest weapon we have in this fight is 
obscure documentation. The early materials that 
accompanyed CP/M, for example, were so good that 
one HeDaP told me CF/M stood for Conspiracy to 
Proted the Winfstja. 1 believed him. 

Oh, the users got a litUe uppity there for awhile when 
those two garage engineers developed the Apple II. I 
must admit it was frightening to see tens of thousands 
of people learning how to use and program a com- 
puter with the books that came with Ihe machine. 
Fortunately, it was only Basic they were learning. 

It is my pleasure to assure you that the Heros of 
DatH Processing have now gained control even at 
^ple. Those books are no longer standard equip- 
ment They cost $50 extra. That should keep the users 
from nosing around too much. 



Even better, however, is Apples policy with its 
Macintosh. You have to be a certified HeDaP to getthat 
computer's $150 programming manual. And the great 
joke is that even if users get a copy it won't help them; 
they need a Lisa to write programs — that kills me. The 
Macintosh is a shoe-in for ttie HeDaP machine of the 
year. 

Believe me, I know how serioie the situatbm is when 
HeDaPs lose control. Fve seen War Games I've seen 
D-on; I know what happens when you let untrained 
individuals loose around a computer. 

1 sleep soundly at n^t knowing ttiat ttie HeDaPs 
have the users on the run. However, I must admit I 
would sleep even better if documention writers would 
write more like scholars and a little less like news- 
paper hacks. Even politicansknow more about proper 
English ttiati most tedmical writers do. 

Tor good examples of scholarly writingwe need turn 
no ftirther than the platform-writing committees of 
last summer's political conventions. The Democrats 
had a gem that went like this, "The Democratic party 
opposes quotas which are inconsistent with the prin- 
ciples of our country." Isn't that beautiful language? It 
is absolutely impossible to tell whether the Democrats 
think all quotas are un-American or if they think some 
are and some aren't and they oppose only the ones 
that are. 

For their part the Republicans wrote, "We . . . oppose 
any attempts to increase taxes which would harm the 
recomy... "00 fiieyopposeMl taxes oronlyfiiose that 
are harmfiil? %u can't tell. This is uAiat scholarly 
writing is all about Obscurify is the foundation on 
u4iich elitism is built 

According to a report in the M&il Street Journal, a 
journalism professor from the University of Kansas 
told a group of newspaper editors this summer, 
"Outside this room, there are only three or four people 
lefl: who know the difference between 'which' and 
thaf " Don'tyou agree it's scary to think that one or two 
of them might be documentation writers? (1 don't 
think we have to worry that any of them are politicians.) 

This unbearably dear-minded professor, whose 
name is John Bremner, insists writers should always 
use "that" to infroduce a clause that is essential to the 
meaning of a sentence. "Which", which should be 
preceeded by a comma, is reserved for clauses that 
add incidental information, according to Bremner. 

I recommend that any technical writers who know 
the diiference bebveen vdiich and that turn them- 
selves in for reprogramming. Then we'll only have a 
few newspaper editors and ttiis guy Bremner to worry 
about 

Deacon Muskrat 
Okefenokee Swamp 

Indeed, documentation that alwaj^ has commas in 
front of whiches Is a darker to HeDaPdom, which 
suits us just fine. 
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